home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / f90 / abs.z / abs
Text File  |  1998-10-30  |  5KB  |  131 lines
  1. ABS(3M)                                                Last changed: 1-6-98
  2.  
  3.  
  4. NNAAMMEE
  5.      AABBSS, IIAABBSS, DDAABBSS, CCAABBSS, CCDDAABBSS - Computes absolute value
  6.  
  7. SSYYNNOOPPSSIISS
  8.      UNICOS and UNICOS/mk systems:
  9.  
  10.      AABBSS (([AA==]_a))
  11.      IIAABBSS (([AA==]_a))
  12.      DDAABBSS (([AA==]_a))
  13.      CCAABBSS (([AA==]_a))
  14.  
  15.      UNICOS and IRIX systems:
  16.      CCDDAABBSS (([AA==]_a))
  17.  
  18. IIMMPPLLEEMMEENNTTAATTIIOONN
  19.      UNICOS, UNICOS/mk, and IRIX systems
  20.  
  21. SSTTAANNDDAARRDDSS
  22.      Fortran 90
  23.      CCDDAABBSS is a compiler extension to Fortran 90
  24.  
  25. DDEESSCCRRIIPPTTIIOONN
  26.      AABBSS is the generic function name.  AABBSS, IIAABBSS, DDAABBSS, and CCAABBSS are
  27.      intrinsic and are elemental functions for the CF90 compiler.
  28.  
  29.      The entry point CCDDAABBSS is provided for support in other languages.  It
  30.      is not recognized as an intrinsic function; therefore, you must use
  31.      the CCDDIIRR$$ VVFFUUNNCCTTIIOONN directive to allow vectorization.
  32.  
  33.      These functions evaluate as follows:  _y = |_x|, except for CCAABBSS and
  34.      CCDDAABBSS, which evaluate the following:
  35.                   2     2 1/2
  36.           _y = |(_x   + _x  )   |''
  37.                  _r     _i
  38.    CCFF9900
  39.      CCDDAABBSS is called implicitly by the Fortran 90 compiler as a result of a
  40.      generic AABBSS call with a complex double argument.
  41.  
  42.    CCAALL RReeggiisstteerr UUssaaggee ((CCrraayy RReesseeaarrcchh SSyysstteemmss OOnnllyy))
  43.      Scalar IIAABBSS:  IIAABBSS%% (call-by-register)
  44.           on entry   (S1) = argument
  45.           on exit    (S1) = result
  46.  
  47.      Scalar DDAABBSS:  DDAABBSS%% (call-by-register)
  48.           on entry   (S1) and (S2) = argument
  49.           on exit    (S1) and (S2) = result
  50.  
  51.      Scalar CCAABBSS:  CCAABBSS%% (call-by-register)
  52.           on entry   (S1) and (S2) = argument
  53.           on exit    (S1) = result
  54.  
  55.      Vector CCAABBSS:  %%CCAABBSS%% (call-by-register)
  56.           on entry   (V1) = argument vector 1 (real part)
  57.                      (V2) = argument vector 2 (imaginary part)
  58.           on exit    (V1) = result vector
  59.  
  60.      Scalar CCDDAABBSS:  CCDDAABBSS%% (call-by-register)
  61.           on entry   (S1), (S2), (S3), (S4) = argument
  62.           on exit    (S1), (S2) = result
  63.  
  64.      Vector CCDDAABBSS:  %%CCDDAABBSS%% (call-by-register)
  65.           on entry   (V1), (V2), (V3), (V4) = argument vector
  66.           on exit    (V1), (V2) = result vector
  67.  
  68.    AArrgguummeenntt RRaannggeess               2450
  69.      infinity is approximately 10
  70.                                                        308
  71.      On UNICOS/mk systems, infinity is approximately 10
  72.  
  73.      AABBSS, IIAABBSS, DDAABBSS:
  74.  
  75.           |_x| < infinity
  76.  
  77.      CCAABBSS, CCDDAABBSS (CCDDAABBSS is not available on UNICOS/mk systems):
  78.  
  79.           |_x |, |_x | < infinity
  80.             _r     _i
  81. NNOOTTEESS
  82.      CCDDAABBSS is an outmoded routine for the CF90 compiler.  Refer to the
  83.      _F_o_r_t_r_a_n _L_a_n_g_u_a_g_e _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, _V_o_l_u_m_e _3, publication SR-3905, for
  84.      information about outmoded features and their preferred standard
  85.      alternatives.
  86.  
  87.      The name of the AABBSS, IIAABBSS, DDAABBSS, and CCAABBSS intrinsic can be passed as
  88.      an argument.  The name of the CCDDAABBSS intrinsic cannot be passed as an
  89.      argument.
  90.  
  91. RREETTUURRNN VVAALLUUEESS
  92.      AABBSS returns the real absolute value of its real argument.
  93.  
  94.      IIAABBSS returns the integer absolute value of its integer argument.
  95.  
  96.      DDAABBSS returns the double-precision absolute value of its
  97.      double-precision argument.
  98.  
  99.      CCAABBSS returns the absolute value of its complex argument as a real
  100.      number.
  101.  
  102.      CCDDAABBSS returns the absolute value of its complex double-precision
  103.      argument as a double-precision number.
  104.  
  105.      When the correct value would overflow, CCAABBSS and CCDDAABBSS abort with a
  106.      floating-point error.
  107.  
  108.      On CRAY T90 systems that support IEEE arithmetic, the following return
  109.      values occur:
  110.  
  111.      AABBSS((_x)):
  112.  
  113.           |_x| = infinity, result is infinity
  114.  
  115.           _x =  NaN, result is NaN
  116.  
  117.      CCAABBSS((_x))::
  118.  
  119.           _x or _y = NaN, result is NaN
  120.  
  121.           |_x| = infinity and _y is not NaN, result is infinity
  122.  
  123.           |_y| = inf and _x is not NaN, result is infinity
  124.  
  125.      When overflow occurs for good input, infinity is returned.
  126.  
  127. SSEEEE AALLSSOO
  128.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-2138, for the
  129.      printed version of this man page.
  130.  
  131.